Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Embedding Controls /

GetSuperControl

NEW WITH THE APPEARANCE MANAGER

Produces a handle to the embedder control.

pascal OSErr GetSuperControl (
                     ControlHandle inControl,
                     ControlHandle* outParent);

inControl

On input, a handle to an embedded control.

outParent

On output, a pointer to a handle to the embedder control.

function result

A result code; see "Result Codes". The result code errControlIsNotEmbedder indicates that the specified control does not support embedding. The result code errCantEmbedRoot indicates that you passed the root control in the inControl parameter.

DISCUSSION

The GetSuperControl function gets a handle to the parent control of the control passed in.

SEE ALSO

"Embedding Controls".

"Appearance Manager Gestalt Selector Constants".